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SECTION A Ti-99/4A CONSOLE 


A.1 GENERAL DESCRIPTION 


Tne purpose of this section is tO provide neccesary information concerning the 
1/0 bus (input/output signal connection) of the T1-99/4A console for persons 
jnterestec in aesianinag peripnerais for the computer. 


sees that readers ot this manual nave @e working knowledge o7 
nics anc computers, especiélly jn recard to the TMS 9900 microprocessor 
Communications Reciszer Unit (CRU) 1/0 technique. Sources for this 
fon are tne TMS9900 Microprocessor Beta Manuel (MPOO1, Revision A) or 
Ol Proarammepie Systems intertace (MPOGs; uuiy, 1978). These books 

V teineco Trom i: Semiconauctor distributors or tne +] Learning Center. 
A giossary is provioed on page 57 of this manual. 


—~—! ot 


ct -* pr (MD e-# 
~3 : 
f O (Dd 


The 1/0 bus provides an interface between the console and its peripherals. 
This bus utilizes both memoryemappea 1/0 and CRU i/Q. ‘the memory bus is 
frequently used for instruction fetch from reac-only memory (ROM) in externa! 
peripnerals anc for data transfer to ana from eee portions of these 
cevyices. The CRU bus is usec for peripneral enable/disable, device contro}, 
and data transfer to/from CRU-mappec portions of these peripnerels. 


ine TMS 9900 microprocessor accesses each peripnera) to obtain instructions 
from the device service routine (BSR) ROM. Since each peripheral contéins its 
own DSR, tne Ti-O9/44 coes not ding to be desianec to anticipate future 
peripnere] requirements. The dual 1/0 bus capability, interrupt hancling, anc 
externéei DSRs provice fiexibility et low cost. 
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FIGURE A. 11-99/4A SYSTEM BLOCK DIAGRAM 
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A.2 1/0 PIN DESCRIPTION 


SIGNATURE PIN 1/0 DESCRIPTION 

AO (MSB) 31 Out 

Al 30 Out ADDRESS BUS 

A2 20 Out 

A3 10 Out AQ through A15 comprise the address bus. 
A4 7 Out This bus provides the 16-bit memory 

A5 5 Out address vector to the external memory 

A6é 29 Out system when MEMEN is active. Address 

A7 17 Out bit 15 is also used for CRU DATA OUT 

A& 14 Out on CRU output instructions. 

AQ 18 Out , 

Al0 6 Out 

All 8 Out 

Al2 ll Out 

Al3 15 Out 

Al4 , 16 Out 

A15/CRUOQUT 19 Out 

DO (MSB) 37 1/0 DATA BUS 

D1 40 1/0 

De 39 I/O DO through D7 comprise the bidirectional 
D3 42 1/0 data bus. This bus transfers memory data 
D4 35 1/0 to (when writing) and from (when reading) 
D5 38 1/0 the external memory system when MEMEN is 
D6 36 I/Q active. 

D7 34 [/0 


BUS CONTROL 


MEMEN 32 Out MEMory ENable. MEMEN indicates a memory access. 

DBIN g Out Data Bus IN. When active (high) the data, 
buffers and 9900 are in the input mode. 

WE 26 Out Write Enable. WE indicates a memory write. 

MBE 28 Out Memory Block Enable. MBE indicates a memory 
access in memory block 4000-5FFr. 

UCLK 22 Out CRU CLocK. Input data line to the Home Computer. 

CRUIN 33 In CRU data IN. Input data line to the Home 

Computer. 


1/0 PIN DESCRIPTION (CONTINUED) 
SIGNATURE IN I/O DESCRIPTION 


MEMORY CONTROL 


READY 12 In READY (wnen MEMEN is active) indicates external 
memory 1S ready for a memory access. 


TAQ 41 Out Instruction AcQuisition indicates the CPU is 
acquiring an instruction during the current 
memory cycle. 


TIMING AND CONTROL 


LOAD 13 In When active, LOAD causes the CPU to execute a 
nonmaskable interrupt; memory addresses FFFC 
and FFFE contain the new workspace and PC 
vectors, respectively. 


RESET 3 Out When active, RESET causes the Home Computer and 
the peripherals to be reset. RESET will be 
held active for a minimum of five clock cycles. 


EXT INT 4 In EXTernal INTerrupt. When active, EXT INT causes 
the CPU to execute an interrupt. 
03 24 = Qut CPU Clock. Phase 3 of the CPU clock. 
POWER 
GND Shuts Ground reference. 
Fn 


SPEECH MODULE SIGNALS 


SBE 2 Qut Speech Block Enable. S&8E indicates a memory 
access in the speech memory. 

AUDIO IN a4 In Input for the audio from the speech module 
+5 l Supply voltage (*+5v Nom) for speech module 
(50ma Max)* 

-5 43 Supply voltage (-5v Nom) for speech module 


(50ma Max)* 


* NOTE: Pins 1 and 43 are not intended for use by consumer. Overload may 
Cause permanent damage to console. 


A.3 MEMORY ALLOCATION 


The memory address space is broken into eight blocks of 8K bytes of memory. 
The third block (addresses 4000-5FFF) is predecoded and made available at the 
1/Q port for the peripherals. The second, sixth, seventh, and eighth blocks 
(addresses 2000-3FFF and AQOO-FFFF) are in the Memory Expansion peripheral. 
For the speech module (addresses 9000-97FF), a predecoded line is available at 


the 1/0 port. 
SYSTEM MEMORY MAP 


HEX ADDRESS 


O-1FFF Console ROM space 
2000 3FFF Memory Expansion Peripheral 
4000-5F FF Peripheral Expansion (predecoded to I/0 connector) 
6000—7F FF Cartridge ROM/RAM (predecoded to GROM connector) 
8000-9F FF Microprocessor ROM, VDP, GROM, SOUND and SPEECH select. 
AOOO-BFFF Memory Expansion peripheral 
COOO-DFFF Memory Expansion peripheral 
EQOO-F FFF Memory Expansion peripheral 


MEMORY-MAPPED DEVICES 


ADDRESSES AQ Al A2 AZ A4& AS Al4 USE 
8000 I 0 0 0 0 0 0 Internal RAM 

( 8300-83FF ) 
8400 l 0 0 0 0 l 0 Sound 
8800 l 0 0 0 1 0 0 VDP Read Data 
8802 l 0 0 0 l 0 1 VDP Read Status 
8000 l 0 0 0 l l 0 VDP Write Data 
8002 l 0 0 0 1 l 1 VDP Write Address 
9000 l 0 0 1 0 0 0 Speech Read 
9400 l 0 0 l 0 l 0 Speech Write 
9800 l 0 0 it l 0 0 GROM Read Data 
9302 1 0 0 l l 0 1 GROM Read Address 
9C00 l 0 0 l l 1 0 GROM write Data 
9002 ] 0 0 l l 1 l GROM Write Address 


NOTE: Memory-mapped devices at addresses >8000 through >9FFF are only 
partially decoded. Thus, the devices will respond not only at the 
base addresses listed above, but also at other addresses within the 1K 
block. For more information, see Section B.1 on page 25. 


A.4 CRU ALLOCATION 


Of the available 4K of CRU bits, the first 1K (addresses O000-O07FE) are used 
internally in the console. The second 1K (addresses O800-OFFE) are reserved 
for future use. The last 1.9K (addresses lOOO-1FFE) are reserved for the 
peripherals to be plugged in the [/0 port. A block of 128 CRU bits is 
assigned to each peripheral as listed below. 


CRU ASSIGNMENTS 


CRU 
ADDRESSES A3 A4 AS AB. AZ USE 


QOOO-OFFE 0 X X Xx X Internal Use 
lOO0-10FE 1 0 0 0 0 Unassigned 

LIOO-1LI1FE l 0 0 0 l Disk Controller Card 
1200-12FE l 0 Q l 0 Modems 

1300-13FE l 0 0 l l RS 232 (primary) 
1400-14FE 1 0 1 0 0 Unassigned 

L500~L5FE l 0 l 0 l RS 232 (secondary) 
1600-l16FE 1 0 1 l 0 Unassigned 

1700-17FE 1 0 l 1 1 HE X~BUSTM 

L800-18FE l 1 0 0 0 Thermal Printer 
LOOO-1FFE l l 0 0 0 EPROM Programmer 
LAOOQ-1AFE 01 l 0 1 0 Unassigned 

IBOO-1BFE 1 l 0 l l Unassigned 

LCOO~1CFE l ‘. l 0 0 Video Controller Card 
IDCO-1DFE l l l 0 1 IEEE 488 Controller Card 
IEQO-l1EFE 1 1 1 1 Q Unassigned 

LFOO-1LFFE l oe l l P~Code Card 


A.5 INTERRUPT HANDLING 


The interrupt available on the [/0 port is one of the maskable interrupts: of 
the TMS 9901 Programmable Systems Interface. 


9900 INTERRUPTS 


VECTOR LOC. 


INTERRUPT (MEMORY ADDR. CPU DEVICE 
LEVEL IN HEX) PIN ASSIGNMENT 
(Hignest OOO0-WSP RESET RESET 
Priority) Q002-PC 
0 FFFC-WSP LOAD LOAD 
FFFE—PC 
l 0004—WSP -- EXT DEV (9901) 
0006-PC 


Interrupting is done only on Level 1. The additional interrupts availabie are 
implemented on 9901. Interrupt Level 1 is decoded by software to be either 
(1) VDP vertical sync., (2) 9901 internal timer, or (3) I/0 bus generated. 


10 


ADDRESS CRU BIT 9 UNCTION 
0000 0 Control Control 
0002 l INTL 17 External Interrupt 
0004 2 INT2 18 Video Display Processor 
Vertical Sync Interrupt 
0006 3 INT g 9901 Internal Timer Interrupt, 
keyboard "=" line, 
joystick "FIRE" 
0008 4 INT4 8 Keyboard "Space" line, 
joystick "Left" 
. QQOA 5 INT5 7 Keyboard "ENTER" line, 
joystick "Right" 
OOOC 6 INT6 6 Keyboard "OQ" line, 
joystick "Down" 
OO0E 7 INT? (P15) 34 Keyboard "FCTN" line, 
joystick "Up" 
0010 8 INTS (P14) 33 Keyboard "SHIFT" line 
0012 9 INT9 (P13) 32 Keyboard "CTRL" line 
0014 10 INT1O (P12) 31 Keyboard "Z" line 
0016 ll INTi1 (P11) 30 Not Used As Interrupt 
0018 12 INT12 (P10) 29 Reserved, High Level 
OO1A-1E 13-15 INTis-INI15 28,27 Not Used As Interrupt 
and 23 
9901 I/O MAPPING 
ADDRESS CRU BIT 9901 PIN FUNCTION 
0020 16 PQ 38 Reserved 
0022 17 Pl sr Reserved 
0024 18 P2 26 Bit 2 of Keyboard Select 
0026 19 P3 22 Bit 1 of Keyboard Select 
0028 20 P4 21 Bit 0 (MSB) of Keyboard Select 
002A 21 PS 20 Keyboard (ALPHA LOCK) 
002C 22 P6 19 Cassette Control l 
(motor control) 
OO2E 23 P7 (INTIS) 23 Cassette Control 2 
‘(motor control) 
0030 24 P8 (INTi4) 27 Audio Gate 
0032 25 P9 (INTIS) 28 Mag Tape Out 
0034 26 P10 (INT12) 29 Reserved 
0036 27 P11 (INTITI) 30 Mag Tape Input 
0038-003E 28-31 P12-P15 31-34 Not Used IN 1/0 Mapping 


9901 BIT ORGANIZATION 
901 PIN F 
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A.6 ELECTRICAL CHARACTERISTICS 


ORIVE CAPABILITY OF 1/Q SIGNALS 


SIGNAL NAME DRIVER 
O3 74LS244 
CRUCLK 74LS244 
We 74LS244 
AO 74LS244 
Al 74L$244 
OBIN 74LS04 
MBE 74LS244 
MEMEN 74LS32 
A3-A14 74LS367 
00-07 74LS245 
A15/CRUOQUT 74.$244 
SBE 74LS03 
HOLD 74LS$32 
RESET 74LS04 
1/0 READ 


A CPU Read cycle for the external device consists of two 8-bit read cycles 
(Figure 8). The two bytes read are assembled as a 16-bit word before they are 
presented to the 9900. Shown in-Figure 8 are two 8-bit read cycles with one 
wait state inserted in each to work with slow memories. 


At the beginning of clock cycle 1, MEMEN goes low true and OBIN goes high 
true. At the same time that MEMEN goes true, the address bus goes active. 
WE stays high false during the entire cycle. 


In order to eliminate noise and glitches (associated with crosstalk and 
Simultaneous switching), a minimum of 100 nanoseconds should be ailowed for 
the address lines to settle. MBE (predecoded from 40, Al, and A2) goes true 
during the leading edge of #2 of clock cycle 1. Oata read from the 
peripnerals must be valid 750 nanoseconds after the start of clock cycle l. 


Tne CPU will look at the full 16-bit data bus during the leading edce of 1 of 


clock cycle 6. Under worst-case conditions, data must be valid 100 
nanoseconds before that time. 
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(4) SETTLING TIME = 100nS (MIN) 
(2) ACCESS TIME FOR DSR ROM + DATA Ts + DATA BUFF DELAY (PERIPHERAL + MAINFRAME) = 650nS (MAX) 
(3) SETUP TIME FOR 9900 = GOnS (MIN) 


FIGURE B. 1/0 READ TIMING 


I/O WRITE 


Figure C shows a 16-bit I/O write cycle. As described earlier, it is composed 
of two 8-bit writes. A write cycle will always be preceded by an ALU cycle. 


MEMEN and OBIN go true (low) at the start of the cycle. time of 100 
nanoseconds (min) is allowed for the address lines to settie. WE goes true 
(low) on the leading edge of ¢2 during the wait states and stays true for 666 
nanoseconds (TYP). 


During a Read or a Write the odd byte (LSBY) is accessed first, then the even 
byte (MSBY). A15/CRUQUT changes its state 1 microsecond (TYP) after the cycle 
is initiated. The second 8-bit write cycle is identical to the first 8-bit 
write. MBE stays true (low) during the entire (1.8 microseconds) cycle. 


1/Q BUS LOADING 


TOTAL SWITCHING MAXIMUM PERIPHERAL 
SIGNAL LOAD (pF ) LOAD (pF) 
00-07 90 
AQ-A2 100 90 
A3-Al14 100 90 
Al5/CRUOQUT 110 100 
03 110 100 
RESE1 100 90 
READY &0 ey ee 
CRUIN 125 90 
CRUCLK 100 30 
MBE 100 90 
WE 100 90 
SBE 35 25 
OBIN 100 90 
MEMEN 100 90 
HOLD 80 70 
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bene a 999nS (TYP) pigs: * 

— 33308 —p CC2 acme CC3 ——wHa— CC4 -—plie— CC5 —— ae oe 
CLOCK (WAIT . (WAIT (WAIT r (WAIT 

ot | | cycle 1] | STATE) | state) | | state) STATE) | | | 
) 
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| VALID DATA 


READY 


(1) SETTLING TIME = 100nS (MIN) 
(2) WE PULSE WIDTH = 578nS (TYP) 
() VALID DATA 


FIGURE C. I/O WRITE TIMING 


CRU TIMING 


CRU interface timing is shown in Figure 0. The CRUOUT cycle is 
composed of two clock cycles. When placed on the address bus AQ 
through Al4, the CRU bit address is allowed to settle for 100 
nanoseconds (min). CRUCLK is a 63 nanoseconds (max) low true signal 
which occurs on the trailing edge of $1 of clock cycle 2. CRUQUT data 
is valid at the start of clock cycle 1 and is latched by the CRUCLK in 
the respective peripneral. 


CRUIN also consists of two clock cycles of 666 nanoseconds (TYP). 
Again 100 nanoseconds is allowed for the address bus to settle. The 
CPU samples the CRUIN line on the leading edge of $1 of clock cycle 

2. Oata must be valid 40 nanoseconds (min) before that. This implies 
an access time of less tnan 400 nanoseconds for CRUIN. 
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CRU OUTPUT 
(1) SETTLING TIME = 100nS (MIN) 


(2) ADD VALID TO CRUCLK = 233nS (TYP) 
(3) ADD VALID TO VALID CRUIN = 400nS (MAX) 


FIGURE D. CRU TIMING 
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FIGURE E. CONNECTOR PIN IDENTIFICATION DIAGRAM 
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FIGURE F. T1-99/4A LOGIC BOARD COMPONENT LOCATION DIAGRAM 


Tit 220 
si | R2 
fob ptt Bor 2.2K 


] a 
WALL | 
TRANSFORMER | 
| 


P/N-1015985.2 


Rae > Tt 
v7 ! ar wide ed 
VAC Wot L2 9001 
60HZ > | 


eae. ay i [= m4 
RECEPTACLE | cS - C6 


=< 

O 
P/N-1501539-1 i 

a 


L3 . 
wang Ea 


U1 


UA7812C 


c9 
3300; 


Ci? 
Vt 


C10 
All 


UAT723C 


Q2 
TIP31 
AR? 214 
3.3K JIMH 
\ 7 PG 10 
992 662 
ng %-96 
RB 5682 
3322 O 412V 
cen? Toe 
C15 Ry ton 
470,16 Tut 
—5V 


UA79MO05C 


C8 
q r 1WWd0pt 
et D7 + C12 
“ a i PG1992 pa 4.Jut 
‘-) 4}ut 4 y ; 
D8 R15 
6.2V ‘47K 
eeeee ee 
Wi 27082 
U4 
i Ti 331 
eno) AV 
W2) 27082 a 
- C16 
We 
«w3 ! 18 Li . 
b 27082 = 
{ 
& 
} 
a! } - @y 
W455 27082 


"Wi THRU W4 ARE CUT TO ADJUST 
THE #5 VOLT OUTPUT. THE WIKES 
MAY BE CUT IN ANY ONDER. 


FIGURE G. Ti-98/4A CONSOLE POWER SUPPLY 


SECTION B--INTERFACE CONSIDERATIONS 
B.1--CPU REQUIREMENTS 


B.l.1 General Comments 


The purpose of this section is to outline considerations necessary or 
advisable for hardware used for interfacing peripherals to the T1I-99/4A. 


Required T]-99/4A timing is shown on pages 12-17 in Section A of this manual, 
and Section D includes details concerning the software requirements for 
peripheral interfacing. 


B.1.2 TI-99/4A Memory Space Organization 


The memory map of the TI-99/4A is as follows. The allocated spaces are shown 
in parentheses, and the actual memory space used is shown where applicable. 
This is notable of the memory-mapped devices (MMD) in the >8000 to >9FFF 
space. All of these devices reside in 1K blocks, and block decoding is used 
to select them. Even though they are shown to respond at the base address, 
they will respond ANYWHERE in the 1K block assigned to them. An example is 
the 256 byte SRAM which is decoded to respond at a base of >8000. This SRAM 
repeats at bases of >8100, >8200, and >8300, and software is written to 
conform to the >8300 base. Note that there is a given amount of space which 
cannot be used because of the basic space definition and the decoding used on 
existing products. 
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B.1.2.1 READ Before wRITE Considerations 


There are different READ and WRITE addresses for most of the memory-mapped 
devices (MMDs). This is because the TMS 9900 does a READ operation at the 
destination address prior to writing to it. Many of the MMDs have internal 
address registers that autoincrement after either a READ or a WRITE 
operation. This autoincrement characteristic of the MMD may not produce the 
desired results if it is not taken into consideration when designs or 
modifications are made. 


The READ before WRITE exists because the 9900 jis a word-oriented machine from 
a memory access standpoint. The several byte-oriented instructions are 
carried out by the machine in a word execution format, and the other byte in 
the word must not be altered. The machine itself must save the unaltered 
byte, concatenate the new byte with it, and return the word to memory. The 
internal logic of the TMS 9900 is designed this way because it was to the 
designers distinct advantage to do this same READ before WRITE on both byte 
and word moves. 


B.1.2.2 Cartridge Memory Space 


The cartridge memory space at >6000 must be treated as if it is logically 
connected to the cartridge port. The GROM chips are rather poor line drivers 
at best, and their life on the [/O data bus is limited. Even though the GROM 
data bus is currently connected directly to the 1/0 data bus, there is no 
guarantee that updated versions of the TI-99/4A will nave the same 
connection. The new generation TI console will probably isolate the GROM data 
bus from the I/O data bus. DON'T TRY TO ACCESS THE CARTRIDGE MEMORY SPACE 
FROM THE [/O PORT: ; 
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TI1-99/4A Memory Map 


Console ROM 
(8K BY) >lFFF 


>2000 
Used by 32K Mem Exp 
(8K BY) > 3FFF 
>4000 
DSR ROM Space 
»(8K BY) > SF FF 


! 
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« 
i 
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: >6000 


Cartridge Memory Space 
(8K BY) >7FFF 
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- >8000 


Console 256 byte RAM 
(1K BY) >83F F 


>8400 
Sound Chip, 1 BY req'd 
-(1K BY) >87FF 


>8800 | 
VDP READ, 2 BY req'd 
(1K BY) >8BFF 


: >8CO00 


t 
e 
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VDP WRITE, 2 BY req'd 
(1K BY) > 8F FF 


| 
t 
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i 
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! 
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- >9000 


Speech Module READ Space 
(1K BY) >O3FF 


'>9400 


TS Gee SSE Gee Ger cee GEE Ge coe OSES GAMO GES GS Gn Gate Gates Caw Wome oe Gee aE eee oe eS ED LOE ae 


>9800 
GROM READ, 2 BY req'd 
(1K BY) > OBFF 


‘>9C00 


GROM WRITE, 2 BY req'd 
(1K BY) > OF FF 


t 
® 


>A000 
Used by 32K Mem Exp 
(24K BY) >FFFF 
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B.1.3 CRU (Communications Register Unit) Space Definition 


As with the memory space decoding, the CRU space devices are not fully 
decoded. Thus, most devices will respond just as well to other addresses in 
their block as tney will to the block base address. By and large, the CRY 
space is allocated to peripherals with only a very small amount devoted to 
internal machine control (keyboard scan, cassette control, etc.). 


B.1.3.1 Disallowed Instructions. 


The control signal “CRUCLK" is also not fully decoded. Because the 
most-significant three address bus bits are not included in the decode, 
certain instructions of the TMS 9900 must be disallowed. These are: 

LREX, CKOF, CKON, RSET, and IDLE... 

DO NOT USE THESE INSTRUCTIONS. THE LOGIC BLOCKS FED BY CRUCLK WILL INTREPRET 
THAT CLOCK SIGNAL AS A CRU OPERATION. 


B.1.3.2 CRU OUTPUT Definition. 


There is a single restriction on the definition of CRU OUTPUT bits for 
peripheral use: the base address bit. This bit must be used to "page in" DSR 
ROM's when SET, and should, where possible, be RESET by the Power-Up RESET 
line in the [/0 Port. Thus, the DSR ROM will be “paged out“ by a RESET 
operation. For more information, see the paragraph on OSR ROM CONSIDERATIONS. 


B.1.3.3 CRU INPUT Definition. 


There is no definition for CRU Input lines, and one is free to define them 
within that peripheral space as desired. 


B.1.3.4 Spare CRU Bit Use. 


Spare CRU bits may be put to good use as test bits. [f spare INPUT and OUTPUT 
bits are available, the ones used should be chosen so that spare INPUT's may 
be connected to spare QUTPUT's (each pair displaced by the same amount from 
the base) to form software FLAG bits. Otherwise, spare INPUTS bits should be 
tied to VCC or GROUND in some manner that will be verified during the power-up 
routine execution for that peripheral. Spare OUTPUT bits may be left 
unconnected or terminated on an etch pad to be connected to automatic test 
equipment. This is particularly useful when combined with signature test 
hardware and test software. 
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CRU MAP 


' 50000 We 
; CPU TMS 9901 space : 
32 lines required ; 
: >OSFE ! 
‘50400 
; Unassigned 
: >OFFE ! 
‘51000 


For test equipment use 
on production line 
(128 Lines) 
>lOFE 
>1100 ; 
Disk Controller 
(128 Lines) 


om Ow em Ome Om Oe OC —- em Om 6 


LIFE. 
‘51200 
; Modem ; 
. slat. : 
'>1300 7 
: ~ Primary RS232 : 
; +isre 
‘51400 
: Unassigned : 
; >L4FE ! 
‘51500 
: Secondary RS232 : 
: >1S5FE ! 
‘51600 
: Unassigned ; 
: >l6FE ! 
‘51700 3 
: HE X-BUS IM 
>1L7FE 
:>1800 


Thermal Printer 


900 
EPROM Programmer 
>1LOFE 


ED CO GE SM Ga GEE GES OA CEES Gate ETE Sout SRE GE GEES GED Gate OER fe ae eS Game GEE GSES EE aE oe 


St 3 tee 


ew @ome@e~ @omwe=-@e” @©= @ eo & 
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. >LAQO 
Unassigned 


SAFE: 
'51B00 
: Unassigned ; 
; >IBFE ! 
'51C00 
: Video Controller Card 
: ; >ICFE ! 
‘51000 
' [EEE 488 Controller Card ! 
: >IDFE ! 
'51£00 
: Unassigned 
: >lLEFE ! 
'S1F00 
: P~Code Card 
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B.1.4 TI-99/4A Peripheral Polling 


The TI-99/4A polis the I/O Port for the presence of peripherals on either a 
software restart or a hardware RESET. This polling starts in the CRU space at 
>1000, and continues in increments of >100 until >1FOO has been polled. 
Power—up routines will be executed for each peripheral as its DSR ROM is 
polled (if the DSR header indicates that a power-up sequence is required). 


B.1.5 Indicator LED 


An indicator LED shall be provided, and shall be driven by a unique CRU CUTPUT 
bit. If all CRU OUTPUT bits have been defined, it shall be acceptable to 
connect the LED drive to the DSR ROM page bit. This LED provides visual 
feedback to the user that the periphera! card is present and active. All 
cards presently marketed by TI must provide this indicator. The LED is amber 
or yellow. 


B.1.6 OSR ROM Considerations 


The OSR ROMs for all peripherals must be based at >4000 and may be contiguous 
through >5FFF. These ROMs must not respond unless the respective CRU DSR ROM 
page bit is set ON (set to a high level with either a SBO instruction or "1" 
data in a LDCR instruction). It is the responsibility of the CPU to insure 
the proper control of all of the DSR ROM page bits. 


B.1.6.1 Extended DSR ROM Techniques. 


ROM Space in excess of 8K bytes may be obtained by bringing sequential 8K 
blocks into the DSR ROM page. Secondary biocks (pages) may be piaced anywhere 
in available TI1-99/4A Memory Space. The secondary page bit may be obtained 
from the assigned CRU space to that peripheral (as was done on the P-Code PCB) 
or by writing to a ROM address and then decoding that condition to strobe a 
flip-flop. The latter method was used on the Extended Basic cartridge to page 
the upper 4K half of that space. Either a data bus or an address bus bit may 
be used for data to the FF. Both schemes provided a nonpaged 4K base ROM, and 
paged the upper 4K half of the space. 
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B.2-—-EXPANSION UNIT REQUIREMENTS 
8.2.1 System Bus Requirements 


There are only two design considerations that must be understood to interface 
with the system bus. One controls a Data 8us driver on the TI-99/4A end of 
the connecting cable, and the other is used during printed circuit board (PCB) 
burn-in. 


B.2.1.1 Remote Data Bus Driver. 


As has been previously noted, there are additional requirements for 
interfacing through the Peripheral Expansion Unit (PEU). Regardless of the 
processor driving the PEU, a signal must be provided to indicate to the 
interface that a memory cycle is being requested for a PCB in the PEU. This 
Signal is termed "RDBENA*", and is used to enable Data Bus drivers on the 
TI-99/4A end of the cable. I[t must function as an open-collector signal, but 
a tri-state gate may de used instead if the input is grounded and the 

igh ices controller is connected in parallel with tnat gate for the Data Bus 
Buffer. 


B.2.1.2 Burn—-In Consideration. 


A single high true line shall be provided to enable the PCB to respond to both 
memory and CRU accesses. This line is held at a high level in the PEU, but is 
driven to allow a parallel connection of 16 PCBs during burn-in. When low, 
this signal shall disable the PC83 from driving any of the system memory and 
CRU bus lines. The interrupt sensing has been excepted from this in the past. 


B.2.2 Power Allocation Assumptions 


The following is a guide for maximum load current a PCB should present to the 
PEU. 


0 250 ma on the *+15v unregulated bus. 
0 500 ma on the *+8v unregulated bus. 
O 30 ma on the -15v unregulated bus. 
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B.2.3 System Bus Pin Definition 
~100" PIN TO PIN SPACING, ATTLEBORO CONNECTOR 


PIN NO. MNEMON IC FUNCT ION 


1 +5yv 3-T Regulator supply voltage 
Va +5y 3-T Regulator supply voltage 
3 GND Logic Ground 
a READY A System READY 
: GND Logic Ground 
6 RESET* Active LOW system-driven RESET 
/ GND Legic ground 
8 SCLK System clock 
9 Lore Second generation CPU indicator. 
O=Second generation CPU; l=TI-99/4 
10 AUD I0 Input audio 
ll RBDENA* Active LOW remote data bus driver 
Enable control line 
12 PCBEN Active HIGH PCB enable for burn-in 
13 HOLD* Active LOW CPU HOLD request 
second generation CPU only 
14 IAQHA IAQ HOLDA logical OR 
Second generation CPU only 
15 SEN ILA* Interrupt Level A Sense Enable 
16 SEN ILB* Interrupt Level B Sense Enable 
Second generation CPU only 
17 INTA* Active LOW Interrupt Level A 
18 LOAD* Low for T1-99/4 Memory Expansion, 
High for linear memory space. 
Second generation CPU only. 
TMS9900 LOAD* input 
19 D7 System DATA Bus, LSB 
20 GND Logic Ground 
21 D5 System DATA Bus 
22 06 System DATA Bus 
23 D3 System DATA Bus 
24 D4 System DATA Bus 
25 D1 System DATA Bus 
26 D2 System DATA Bus 
o/ GND Logic Ground 
28 DO System DATA Bus, MSB 
29 Al4.A Address Bit 
30 A15/CRUOUT.A Address Bit, LSB 
3] Al2.A Adaress Bit 
32 A1l3.A Address Bit 
33 Al0.A Address Bit 
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System Bus Pin Definition (Continued) 


MNEMONIC 


Al1.A 
AQ8.A 
AQO9.A 
AQ6.A 
AQ7.A 
AQ4.A 
AQ5.A 
AQ2.A 
AQ3.A 
AQQ.A 
AOL.A 
AMB.A 
AMA.A 
GND 
AMC .A 
GNO 
CLKOUT* 


CRUCLK .A* 


DBIN.A 
GND 

WE .A* 

CRUIN 


MEMEN .A* 


Address 
Address 
Address 
Address 
Address 
Address 
Address 
Address 
Address 
Address 
Address 
Address 
Address 


FUNCTION 


Bit 
Bit 
Bit 
Bit 
Bit 
Bit 
Bit 
Bit 
Bit 
Bit 
Bit 
Bit, normally HIGH 
Bit, normally HIGH 


~ Logic Ground 


Address Bit, MSB normally HIGH 
Logic Ground 

Active LOW CPU CLOCK 

Active LOW CRU Output Clock 

Data Bus Dir'tn, HIGH is CPU READ 
Logic Ground 

LOW true CPU Write Enable 

HIGH true CRU Input data 

Active LOW memory request 

-l2v 3-T Regulator supply voltage 
-12v 3-T Regulator supply voltage 
+12v 3-T Regulator supply voltage 
+1i2v 3-T Regulator supply voltage 


B.3--DESIGN AND DEVELOPMENT REQUIREMENTS 


This listing covers both hardware and PCB design rules. 


0 


Each PCB must be completely disabled by an active low disable (active 
high enable). The disable must disable both memory and CRU functions 
on the PCB and is used for burn—in purposes. | 


The +l2v, -5v, and -l2v power etches shall be double spaced from other 
etches where possible. This minimizes a TIL to power line short or a 
power etch to power etch short. 


Signals such as CRUIN that are taken very far from the system 1/0 
connector shall be guarded with GROUND etch. Where practical, these 
Signals should be buffered with tri-state buffers. 


Buffers to drive the bus must be physically close to the I/O Bus. The 
prototyping PCBs have most of this already in place, but signals such 
as READY and CRUIN do not have them because they are not always used. 
A connection to the system bus constitutes a stub connection, which 
generally obeys transmission line theory. These stubs snould be kept 
as short as is practical. 


All 19 system address bits shall be included in the memory space decode 
for that peripheral. Assume AMC, AMB, and AMA to be in the high state. 


Address lines AOQQ through AO7 shall be included in the CRU Space decode 
even though the TI1-99/4A assumes AQQ thru AQ2 to be zero. 


There are two levels on which to interrupt, but the TI-99/4A supports 
only one (INTA*). THIS IS THE ONE YOU MUST USE. Interrupt level 
Status bits are defined by the Personal Computer PCC at Texas 
Instruments, and for the moment are not sensed by the TI-99/4A. if 
they were to be sensed, the TI-99/4A would cause a line to go low 
(SENILA*), which tells the PCB logic to gate its status bit to the 
System data bus. 


As a design aid, the Personal Computer Group has available a 
prototyping printed circuit board (PCB). This PCB will accomodate 
about 36 l6-pin DIP sockets, and has the necessary system bus buffers 
jn place with etch connections to the system 1/0 pins. The PCB 
designer need only to hook the buffered signal to his logic desian. 
Schematics of this PCB are available (TI part number 1039334) and 
Standard 7T1-99/4A timing diagrams shouid be used for the PEU PCB Design. 
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Section C--FILE MANAGEMENT SPECIFICATIONS 
C.l Introduction | 


This document contains a complete specification for the file management system 
of the TI1-99/4A Home Computer. 


The text in this document has been completely revised to reflect changes that 
have been made to facilitate new options in the T1-99/4A Home Computer. 


The TI-99/4A Home Computer will support all file features described in this 
document. Some minor additions have been made concerning the status 
(C.3.2.10) and the error code section (C.3.4) to reflect changes for the 
TI-99/44 Disk Peripheral. These changes do not affect any DSR that currently 
exists. 


Section C.4.3 has been provided to give information to the GPL applications 
programmer on how to access DSRs and for the peripheral programmer on how the 
information is passed on a DSR. 


C.2 1/0 Handling 


The approach used in the TI-99/4A Home Computer File Management System has 
been that all devices should look the same to an application program. 
Therefore when peripherals are added to the computer, it should not affect the 
BASIC interpreter. Only the peripheral driver (Device Service Routine, or 
OSR) will have to be added to the software. 


All peripherals for the TI~99/4A Home Computer, with the exception of the 
keyboard/display, are considered equivalent by an application program, within 
physical limitations (reading data from a thermal printer is clearly 
impossible). These physical limitations are determined in the device service 
routine and returned to the application program as an error condition. 


The TI-99/4A Home Computer File Management System supports both random and 
sequential access files. Both file types use the same supervisor call 
mechanism in order to insure a high degree of device independence. Hardware 
devices (such as a line printer) are accessed as sequential files except that 
no file name is appended to the device name. 


The following sections describe the file structures available to the BASIC 
interpreter, how to create and delete files, and how to perform file I[/0. 


Two different kind of file organizations are supported: 


o Sequential files 
o Relative record files (random access) 


C.2.1 File Organization and Use 


Tne following paragraphs discuss the file organization and use for each of 
the two file types. 


C.2.1.1 Sequential Files 


Sequential files are both used for disk-based files and for [/0 to other 
devices. They consist of fixed or variable record length files whose 
records are always accessed serially, like the output to the thermal 
Orinter. 


C.2.1.2 Relative Record Files 
Relative record files are also called random access files because, unlike a 
sequential file, records may be accessed in an arbitrary order. Therefore 


relative record files can only be supported on random access media such as 
floppy disks. 
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The records within a relative record file are addressed by a unique record 
number. TO access record X, the value X has to be placed in the 
appropriate field of the 1/0 Peripheral Access Block. The range of record 
numbers is from zero to one less than the number of records in the file. 
Records in a relative record files are a fixed length, specified at file 
creation. 


Records in a relative record file can also be accessed in a sequential way 
by specifying only the first record in the sequence. The supervisor then 
automatically updates the record number each time after a record has been 
read. 


C.2.2 File Management Overview , 
C.2.2.1 Terminology 


A file consists of a collection of data groupings called logical records. 
This division of the file into logical records does not necessarily 
correspond to the physical division of data on the medium (like a sector on 
a disk). Thus there are two types of records: 


© Logical records--The data grouping of a file as seen by an 
application program. 


Oo Physical records--The buffers physically transferred between 
memory and medium. : 


Relative file 1/0 from a program is done on a logical record with a fixed 
length. This enables the system to compute the actual location of any 
logical record relative to the beginning of file. 


Sequential files allow both fixed and variable length records. 


When a file is created, the logical record size must be specified. For 
relative record files this size must be exact. For sequential files the 
specification indicates an upper limit for the size of a variable record, 
or the exact length of a fixed-length record. In case a zero is specified 
for either filetype, the DSR must select a default for the record size. 


The physical record size for any medium is specified within the DSR and is 
implementation dependent. 


C.2.2.2 File-Type Attribute 


The file-type attribute specifies the format in which the data in 
the file is represented. The two file types are: 


Q DISPLAY—Displayable or printable character strings. 
Each data record corresponds to one print line. 


0 INTERNAL—Data in INTERNAL machine format. 
The file-type attribute is internal to the application program. [t is 
merely stored and passed on by the OSR as a distinction between two data 
types, without affecting the actual data stored. 
C.2.2.3 Mode of Operation 


A file is opened for a specific mode of operation, specified in the OPEN 
[/O call. The four modes of operation are: 


fo) INPUT = The contents of the file may be read, but may not be 
altered. 
0 OUTPUT - The file is being created. Its contents may be 


written but not read. 


a) UPDATE —- The contents of the file may be both written and 
read. Note that this mede of operation is only be 
Supported by random access devices. 


fe APPEND ~ New data may be added at the end of the file, Sut the 
contents of the file may not be read 


Each OSR decides whether or not a specific mode for an I[/0 operation can be 
accepted by the corresponding device. 


C.2.2.4 Temporary Files 
In the subsets of TI standard BASIC used for the TI-99/4A Home Computer, 
the file-life attribute is not implemented. Therefore there is no need for 


the File Management System to support temporary files, and all files are 
permanent by definition. 
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C.3 Implementation 


As mentioned in section C.2, the DSRs should present a uniform interface 
between the File Management System and the peripherals. This section will 
give details about implementing this interface. 


C.3.1 Peripheral Access Block Definition 


All DSRs are accessed through a Peripheral Access Block (PAB).- The 
definition for the PAB is the same for every peripheral. The only 
difference between peripherals, as seen by any application program, is that 
some peripherals will not support every option provided for in the PAB. 


All PAB's are physically located in VDP RAM. They are created before the 
OPEN call and are not to be released until the 1/0 has been closed for that 
device or file. 


Figure C.3.1.1 shows the layout of a PAB. The PAB has a variable length, 
depending upon the length of the file descriptor. 


The meaning of the bytes and bits within the PAB is explained below. 
Byte Bit Meaning 


0 - I/Q opcode—— Contains opcode for the current 1/0 
call. A description of the valid opcodes 
are given in section C.3.2. 


] - Flagbyte/status— All the information the system needs 
about file-type, mode of operation, and 
data-type is stored in this byte. The 
meaning of the bits within this flagbyte 


1S: 
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- « « ‘== Filetype 

» ae ae Mode of operation 
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---—-————----—— Recordtype 
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‘ 
ee | enn enmee— Errorcode 
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1 0 
ey 
3 
4 
5-7 
his - 
4 s 
5 re 
6,7 - 


Meaning 
Filetype--Indicates file-type. 


Q 
1 


Sequential file 
Relative record file 


Mode of operation—-Indicates operation mode for which 
file has been opened. 


OO = UPDATE 
Ol = OUTPUT 
10 = INPUT 

11 = APPEND 


Datatype--Indicates type of data stored in the file. 


O = DISPLAY type data 
1 = INTERNAL type data 


Recordtype-—-Indicates type of record used. 


QO = Fixed length records 
1 = Variable length records 


Error code-—-These three bits indicate, in combination with 
the [1/0 opcode, the error type that has 
occurred (0 = no error). 


Data buffer address--Address of the data buffer the data 
has to be written to or read from. 


Logical record length--Indicates the logicai record 
length for fixed length records, or the maximum 
length for a variable length record (see - 
flagbyte). 


Character count-—Number of characters to be 
transferred for a WRITE opcode, or the number 
of bytes actually read for a READ opcode (not 
equivalent to INPUT and OUTPUT mode). 


Record number--Only required if the file opened is 
of the relative record type. Indicates the 
record number the current 1/0 operation is to 
be performed upon (this limits the range of ° 
record numbers 0-32767). The highest bit will 
be ignored by the OSR. 
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Byte Bit Meaning 


8 - Screen offset—-Offset of the screen characters in 
respect to their normal ASCII value. 


9 - Name length--Length of the file descriptor following 
the PAB. 
10+ - File descriptor—-Device name and, if required, the 


filename and options. The length of this 
descriptor is given in 9. 


ED TED CES TEED GD GERD AD GES GED CAD GED ERT ERS GE CEP GES GERD GREP GEIS GED SETS EES GSD SEED GND GPTS GED GR GEE GED ES WEED a ES Ge GA ee GE GS Ges ee EE x 


' 9 I/O OPCODE 4 FLAG / STATUS ! 
ae : 
DATA BUPFER ADDRESS } 
1 4 gs. 
' LOGICAL RECORD LENGTH ! CHARACTER COUNT , 
: 5.7 ; 
! RECORD NUMBER ! 
: ihe ae ! 
SCREEN OFFSET NAME LENGTH } 
ee . 


Figure C.3.1.1 PAB Layout 


C.3.2 1/0 Opcodes 


This section describes the valid opcodes that can be used in a PAB. These 
valid opcodes are shown in Figure C.3.2.1. 


The following section will describe the general actions invoked by an 1/0 


call with each of the 1/0 opcodes. Each 1/0 call returns any error codes 
in the FLAG/STATUS byte of the PAB. 
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Opcode Meaning 


00 OPEN 

Ol CLOSE 

02 READ 

Q3 WRITE 

04 RESTORE /REW INO 
05 LOAD 

06 SAVE 

07 DELETE 

08 SCRATCH RECORD 
Q9 STATUS 


Figure C.3.2.1 1/0 Opcodes 


Ce3seek OPEN 


The OPEN operation should be performed before any data transfer operation 
except LOAD or SAVE. The file remains open until a CLOSE operation is 
performed. The mode of operation for which the file has to be opened 
should be indicated in the flagbyte of the PAB. In case this mode is 
UPDATE, APPEND, or INPUT, the record length will be returned in byte four. 
Any given non-zero record length will be checked against this stored 
length. For QUTPUT the record length can be specified, or a default can be 
used Dy specifying record length zero. 


For any device, an OPEN operation must be performed before any other [/0 
operation. The DSR need only check the record length and [/0 mode on an 
OPEN. Changing [/O0 modes after an OPEN may cause unpredictable results. 


Codvese. bheae 


The CLOSE operation informs the OSR that the current [/0 sequence to that 
OSR has Deen completed. 


After the CLOSE operation, the space allocated for the PAB may be used for 
other purposes. As long as a PAB is connected to an active device, the 
contents of that PAB must be preserved. 


If file or device is opened for OUTPUT or APPEND mode, an EOF (end of file) 
record is written to the device or file before disconnecting the PAB. 


Vedeaed READ 


The READ operation reads a record from the selected device and copies the 
bytes in the specified buffer. The buffer address is specified in PAB 

entry 2 and 3; the buffer size is specified in PAB entry 4. The actual . 
number of characters stored is returned in PAB entry 5 (CHARACTER COUNT). 


If tne length of the input record exceeds the buffer size, tne remaining 
characters will be discarded. 


C.3.2.4 WRITE 


The WRITE operation writes a record from the buffer specified in the PAB to 
the specified device. The number of bytes to be written is specified in 
byte five of the PAB. | 


C.3.2.5 RESTORE/REWIND 


The RESTORE/REWIND operation repositions the file READ/WRITE pointer either 
to the beginning of the file, or, in the case of a relative record file, to 
the record specified in bytes six and seven of the PAB. 


A RESTORE can only be used if the file is opened for INPUT or UPDATE mode. 
For relative record files, a RESTORE could be simulated in any 1/0 mode by 
specifying the record at which the file has to be positioned in bytes six 

and seven of the PAB. The next I/O operation then automatically uses the 

indicated record. 


C.3.2.6 LOAD 


The LOAD operation loads an entire memory image from an external device or 

file into VDP RAM. All the control information the application program 
needs should be concatenated to the program image. No intermediary buffers 
er used. The entire memory image is dumped starting at the specified 
ocation. 


Tne LOAD operation is a stand-alone operation, i.e. the LOAD operation is 
used without a previous OPEN operation. 


For the LOAD operation, the PAB needs to contain the following information: 
Bytes 2,3--Start address of the memory dump area 
Bytes 6,/--Number of bytes available. 


Aside from the 1/0 opcode and the file descriptor, no other PAB entry is 
required for a LOAD operation. 


Godsend GANS 


SAVE is the complementary operation for LOAD. [It is used for writing 
memory images to a device or file. All necessary control information 
Should be linked to the memory image, so that the information plus program 
image use on contiguous memory area. Again, only a small part of the PAB 
is used . Aside from the usual information (1/0 opcode and file 
descriptor), the PAB contains: 


Bytes 2,3--Start address of the memory area 


Bytes 6,/——Number of bytes to be saved. 
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Gasetee VELETE 


The DELETE operation deletes the specified file from the specified device. 
This operation also CLOSEs the [1/0 sequence. 


C.3.2.9 SCRATCH RECORD 


The SCRATCH RECORD operation scratches the specified record from the 
specified relative record file. The record to be scratched is specified in 
bytes six and seven of the PAB. This operation will cause an error for 
sequential files and devices. This operation is not currently supported by 
any device. 


C.3.2.10 STATUS 
This information can be asked for at any time, although some information is 
only meaningful if a file has been opened for access. 


To indicate the current status of the file, byte eight (SCREEN OFFSET) is 
used. Upon the OSR call byte eight should contain the usual screen 
Characters base address. The DSR can use only this byte and is guaranteed 
not to destroy any other entry in the PAB. 


The meanings of the bits within byte eight after return from the OSR are: 


0 Logical end of file. If this bit is set, the file is at the end 
of its previously created contents. This is usually the case if 
the file has been opened for APPEND mode. Oepending upon the 
mode of operation for which the file has been opened, data can 
still be written to the file (APPEND, OUTPUT or UPDATE mode). 
However, a “read" operation will cause an ATTEMPT TO READ PAST 
EOF error to occur. 


1 Physical end of file. If set, no more data can be written, since 


the physical limits of the device have been reached. Generally 
this means an end of medium nas been detected on the device. 
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Record type. If set, the record type is VARIABLE length. If 
cleared the record type is FIXED length. 


Filetype. If set, the file is a program file. If cleared, the 
file is a data file. 


Data type. If set, the data type is binary (INTERNAL). If 
cleared the data type is ASCII (DISPLAY) or file is program file. 


Reserved for the future use. Fixed to zero in the current 
peripherals. 


PROTECT flag. If set, the file is protected against 
modifications. If cleared, the file is not protected. 


File requested does not exist. A device will not set this Dit, 
which means that on a device, any file exists. 


Bits twom-seven are valid if the file has not previously been opened. Bits 


zero and o 
access. A 
zero in th 


ne can only be used for files that are currently opened for 
File that is not currently open for access should indicate 4 
ese two bits. 


C.3.3 Error Codes 


The File Management System supports a number of error codes. They are: 


Error 


Code 


0 
1 


GZ 


Meaning 

Bad device name; the device indicated is not in the system. 
Device is write protected. 

Bad open attribute such as incorrect file type, incorrect 
record length, incorrect 1/0 mode, or no records in a 


relative record file. 


Illegal operation; i.e. an operation not supported on the 
peripheral or a conflict with the OPEN attributes. 


Out of table or buffer space on the device. 

Attempt to read past the end of file. When this error 
occurs, the file is closed. Also given for non—extant 
records in a relative record file. | 


Device error. Covers all hard device errors such as parity 
and bad medium errors. 


File error such as program/data file mismatch, non-existing 
file opened in INPUT mode, etc. 
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C.4 OSR Operations 


This section describes how a variety of DSRs should react on the different 
1/0 calls. It also discusses detailed software operations descriptions 
such as available registers and memory. 


C.4.1 OSR Actions and Reactions 


In the Home Computer File Management System, several assumptions are made 
about the way in which OSRs should react on conditions such as errors, 
special I/O modes, defaults, etc. This section is intended to explain the 
reactions of a OSR on these conditions. 


C.4.1.1 Error Conditions , 
C.4.1.1.1. Non-existing OSRs 


[f a non-existing DSR is called by an application program, the File 
Management System will automatically return with the COND bit set. In this 
case, no OSR has actually been called, so the error code will snow no 
errors. 


The OSR search mechanism of the File Management System takes care of 
searching for the requested DSR. It tries to match the file descriptor to 
the DSR entries in the system. The matching algorithm matches the end of 
the descriptor, or the first period, whichever comes first. This enables 
the applications program to add special information for the DSR in the file 
descriptor, such as filename, BAUD-rate, print-width, character set, etc. 


C.4.1.1.2 OSR—detected Errors 


OSR-detected errors (see section C.3.4) should be indicated in the flag 
byte of the PAB. It is the application program's responsibility to clear 
this flag byte before every I/O call, and check it after the I/O call. 
This type of error is NOT indicated with the COND bit. 


The OSR may provide additional information about the error type in the [/0 
opcode byte, althougn it is good practice not to destroy the least 
Significant four bits of this byte, since they specify tne [/0 call. 


At no time should the OSR use bits zero--four of the flagbyte for error 


indication, since these bits might contain vital system information 
about the file device. 
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C.4.1.2 Special 1/0 Modes 


To enable the application program to use special device-dependent 
functions, the File Management System DSR search algorithm only uses 4a 
well-defined part of the file descriptor for its search (see section 
C.4.1.1.1). The remainder of the descriptor may be used to indicate 
special device-related functions such as BAUD rate, print width, etc. It 
is advisable for a DSR to ignore descriptor parts it doesn't recognize, so 
that the same appiication program might be used for different devices. In 
the latter case it would handle specific device—dependent functions only if 
the device used was capable of performing them. If the descriptor dealt 
with a function not applicable to a particular device, the DSR would not 
recognize the descriptor and would ignore it. 


An example of a special 1/Q mode descriptor could be 
RS232.BAUDRATE=1200.DATABITS=7.CHECKPARITY.PARITY=00D 
C.4.1.3 Default Handling 


Sometimes, especially if a file is opened for UPDATE, INPUT, or APPEND, it 
is useful to provide a default value for the record length. In the above 
cases, the application program will usually use the value specified on file 
creation. Therefore, if the application program does not provide a value 
for the record length, the DSR should provide this value for it. In case 
the application program does provide a record length, the DSR should check 
this value against the value given on record creation. An error should be 
indicated in case of incompatibilities between stored and provided record 
length. If logical record length is given as zero on OPEN, the DSR must 
provide a default record length. 


C.4.2 Memory Requirements 


Because of the limited amount of register memory (256 bytes of RAM), the 
register usage for DSRs has to be restricted to the following 
registers/memory to avoid interference with application programs 


o Registers RO--R10 of the calling workspace. 


o Memory locations >DA through >DF are available if the DSR is 
called in a non interrupt-driven mode, i.e. through a standard DSR 
entry. 


o A standard scratch area of 36 bytes, at locations >4A through >6D, 
has been assigned for DSR usage. 


The base address for CPU memory in the TI-99/4A Home Computer is >8300. To 
allow for future changes in this base address, it will be derived from the 
Given value of the workspace pointer. This means the loss of one of the 
workspace registers for this purpose. 
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C.4.3 GPL Interface to OSRs 


The GPL interpreter interfaces to DSRs through the monitor. The GPL 
program that wants to access a OSR has to use the following GPL CALL 
sequence: 


CALL >10 
DATA 8 


This will cause the monitor to start searching for a OSR with the same name 
as the string pointed to by CPU location >56. This search routine will 
stop comparing names at the end of the given string or at the first 
imbedded period, wnichever comes’first. 


On the OSR side, CPU location >56 is left pointing at the first character 
behind the DSR name, i.e. a period or an end of string. CPU location >54 
contains the DSR name length (one word). To get the start address of the 
PAB in VDP RAM, the following formula has to be computed: 


CPU(>56) - CPU(>54) - >0A 
The result will point at the I/O OPCODE entry in the PAB. 
[It is up to the OSR to check for any switches in the name. For this 
purpose the length of the PAB name string has been given in the PAB. 
Comparing this length against the length given in CPU location >54 will 
show if the user specified more than just the DSR name. 
C.5 Linkage to BASIC 


This section describes the way the BASIC versions of the Professional 
Computer and the Home Computer are linked to the File Management System. 


This section also describes now to access PAB's from GPL subroutines that 


are callable from BASIC and assume a PAB link structure has been set up Dy 
BASIC. 


46 


C.5.1 BASIC PAB modifications 


Aside from the control information contained within the PAB, as already 
discussed in section C.3, BASIC adds four more bytes to the top of the PAB 
for specific BASIC-related control information. The new PAB structure 
within BASIC is drawn in Figure C.5.1. 


RECORD NUMBER 


ay 


14... 


(O04 
“INK TO NEXT PAB IN CHAIN 
9 ey 
' CHANNEL NUMBER =! ~—sSINTERNAL OFFSET 
‘4 ie & 
1/0 OPCODE ' FLAG / STATUS 
<E9 
| DATA BSUPFER ADOR Bes 
1g SS 
‘LOGICAL RECORD LENGTH ! CHARACTER COUNT 
110,11 


1 SCREEN OFFSET NAME LENGTH 


FIGURE C.5.1 Modified PAB Layout 


The additional four bytes contain additional control information BASIC 
needs for its internal PAB linkage structure. The PAB's within the BASIC 
control structure form a simple linked list, which means each PAB has a 
pointer to the next PAB in the system. The last PAB in the list has a zero 
("O") link, indicating that it is at the end of the list. 


Bytes 0 and 1 in the BASIC PABs contain the link mentioned above. Byte 2 
contains the actual BASIC channel or file number (1-255); byte 3 contains 
the offset of the current data pointer within the data block. 


The offset indicated in byte 3 of the BASIC PAB indicates the position of 
the current data pointer within the data buffer given in bytes 6 and 7. If 
byte 3 equals zero, the current data buffer is "blank"; i.e. if in “read” 
mode, a new buffer has to be read in before any further processing, but in 
"write" mode the entire buffer is still available for data storage. 


47 


If byte 3 is non-zero, it contains an "offset" within the data buffer. 
Added to the start address of the data buffer, it will give the actual 
address of the first data byte to be read or written. This is only the 
case if we have pending PRINT operations (the most recent PRINT ended on 
";" or ",“) or pending INPUT operations (the most recent INPUT ended on a 
"o"). In all other cases, byte 3 will be zero. 


C.5.2 BASIC PAB Linkage 


As mentioned already, BASIC utilizes a simple linked structure for the 
management of its PAB's. Each PAB contains a iink to the next PAB in the 
chain. In order to access the chain, we need to have a link to the first 
PAB in that chain. This link is given in CPU location >3C for GPL 
programs, which is equal to location >833C in 9900 assembly language. 


A graphical representation of the link structure could be: 


CPU RAM fai ihlaredds ioe RET 8) gic lean aie 
003C OF AB 0627 OD1A 
RE feces. BE Uyeeni deweeees 1 Ea ea 
Fos : - |! th ce 
CO centmtipiinnniinniiinid! PORE eI 
aa i ! i 
" PAB no. 1! : PAB no. 2! 


8 
~< 


FIGURE C.5.2 BASIC Link Structure 


Please note that all PAB's are located in VDP memory, whereas the initial 
link to them is located in CPU memory. Also note that although usually the 
PAB's will be allocated in lexical order, depending upon the program, tney 
can be allocated in any arbitrary order. 
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Section D—DSR SPECIFICATIONS 
BR Introduction 


This document describes the hardware and software interfaces between the 
console and peripherals of the TI-99/4A Home Computer family. The purpose 
of this document is to provide a reference for third parties who want to 
design new peripherals for the TI-99/4A family. 


D.1.1 General Interface 


Each peripheral should incluce a nonvolatile Device Service Routine (DSR) 
software package to drive the peripheral. The OSR communicates with the 
console software through certain memory locations. The console software 
sets up information in these memory locations and passes it to the 
user-selected peripheral. From there on, the selected peripheral's DSR 
Should have the capability to interpret the information set up by the. 
console software, physically drive the peripheral, and pass the 
peripheral's data or status to the console software if neccessary. 
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0.2 I/0 Bus—-The purpose of this section is to describe the pin assignments 
of the I/O Bus, funtions of I/0 signals, sources of Output Signals, and 
destinations of Input Signals. 


0.2.1 1/0 Bus Pin Assignments and Descriptions 


Pin No. Notation 1/0 Description 
l +5V 0 5V Power Supply 
2 SBE 0 Low when MPU read from >90XX or write to >94XXxX 
memory 
3 RESET 0 Master Reset, low active 
4 EXTINT if External Interrupt, low active 
5 A5 0 Address Bit 5 
6 Ald 0 Address Bit 10 
7 A4 0 Address Bit 4 
8 All 0 Address Bit ll 
9 DBIN 0 Derived from MPU's DBIN pin, same parity 
10 A3 0 Address Bit 3 
ll Al2 0 Address Bit 12 
12 READY I If device or memory is ready after being 
addressed by MPU in memory R/W cycle, device or 
memory should cause this input to go high 
13 LOAD I To 9900's LOAD pin 
14 A8 0 Address Bit 8 
15 Al3 0 Address Bit 13 
16 Al4 0 Address Bit 14 
17 A7 0 Address Bit 7 
18 AQ 0 Address Bit 9 
"19 A15/CRUOQUT 0 CRU Output/Address 8it 15, LSB 
20 A2 0 Address 8it 2 
21 GND 0 Signal Ground 
22 CRUCLK 0 Inversion of MPU's CRUCLK pin 
23 GND Q Signal Ground 
24 03 e) Inversion of Phase 3 Clock 
25 GND 0 Signal Ground as 
26 WE 0 Derived from MPU's WE pin, same parity 
27 GND 0 Signal Ground 
28 MBE Q Low wnen MPU addressing >4000-->5FFF Memory 
29 A6 0 Address Bit 6 
30 Al 0 Address Bit 1 
31 AQ 0 Address Bit 0, MSB 
32 MEMEN 0 Derived from MPU's MEMEN pin, same parity 
33 CRUIN e CRU Input to MPU 
34 07 [/O Data Bus Bit 7, LSB 
35 04 1/0 Data Bus Bit 4 
36 D6 1/O Oata Bus Bit 6 
37 DO T/Q Oata Bus Bit 0, MSB 
38 05 1/0 Data Bus Bit 5 
39 D2 I/O Oata Bus Bit 2 
40 D1 1/0 OData Bus Bit l 
4} TAQ 0 MPU's [AQ pin 
42 03 1/O Oata Bus Bit 3 
43 -5V 0 -5V Power Supply 
44 AUDIO IN I To Sound Generator Controller's AUDIO IN pin 


D.3 Hardware Structure of DSR 


D.3.1 DSR ROM 


Normally, a DSR is written in the 9900 Assembly Language and is housed in a 
ROM, which is itself part of the T1-99/4A family's peripheral. All DSRs must 
begin at address >4000 and should not exceed >5FFF. All of the eight data 
pins of the DSR ROM must be buffered before being connected to the data bus of 
the 1/Q Bus. This buffer is enabled and disabled by a preassigned CRU output 


bit which is controlled by the console software, so that not more than one DSR 
is accessed at any time. 


D.3.2 CRU Mapping 


The CRU 1/0 is used by the system to access -the peripherals, if the speed of 


data transfer is not too crucial. The decoding format for the CRU addressing 
is indicated as: 


AO Al A2 A3 A4 AS A6 A7 A8 AS AlO All Al2 Als Al4 A15/CRUOUT 
0 Q Q User ID Device CRU 1/0 Bit Decode 0 


The CRU address space, ranging from >0 to >l1FFE with AQ, Al, A3, and Al5 
unused, is broken into eight blocks of 512 bits each. The User ID, indicated 
through the Address Decoding of A3, A4, and A5, represents each of the 512 Bit 
Block. They are assigned as follows: 


MPU Address A3 A4& A5 Assignment 
OO000-03FE O..4.0 Console Use 
1O00-13FE in70...0 TI Peripheral Space No. l 
1400-17FE | eae * ae TI Peripheral Space No. 2 
1800-1BFE : ashe eae © TI Peripheral Space No. 3 
1COO-I1FFE be de TI Peripheral Space No. 4 


The standard device decoding through A6 and A7 gives a total of four device 
blocks within each User ID 8lock. The CRU I/O Bit decoding through A&Al14 
allows 128 addressable bits each of input and output. In the 128 CRU Output 
bits, the first bit, with A&-Al4 all O's, is reserved for enabling the Data 
Buffer of the DSR ROM in each peripheral as mentioned in the last subsection. 
Setting this bit to logic one enables the DSR ROM, while setting it to logic 
zero disables the DSR ROM. 
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0.4 Software Structure of OSR 


A OSR must follow a specific format in order to communicate with the console 
software properly. The purpose of this predefined format is to let the 
console software have the least overhead and the OSR have the maximum 
flexibility in device servicing. 

A OSR, in general, contains the following elements: 


1. Symbol Definition Block 

2. Header and Linkage Block 

3. Power-up Routine (optional) 

4. Main Device Service Routine 

5. Interrupt Routine (optional) 

Each of the above elements will be discussed in detail in the following 
sections. | 


D.4.1 Symbol Definition Block 


The Symbol Definition Block serves two purposes. First, it equates frequently 
used data or addresses with symbols for ease of recognition. Secondly, it 
specifies tne CPU RAM location in a certain way so tnat each DSR can be used 
around future and existing CPU family members such as the TI-99/4 and the 
TI-99/4A with the least modification. The first purpose is common in every 
program, but the second one needs more explanation. 


Each model in this family has a different memory structure within the 

console. Therefore, care must be taken in handling memory addressing in a DSR 
so that the OSR can support future Home Computer models. The console software 
always enters the OSR through the instruction: 


BL *RI 


where RQ contains the OSR entry address. Upon entry of the DSR, the workspace 
pointer contains the beginning address of the Register File, which the console 
software uses. I[f all the CPU RAM's which tne OSR may access are predefined 
with respect to this workspace pointer, the OSR does not have to know the 
memory map of each console. The OSR can address each CPU RAM through index 
addressing via the workspace pointer. For example, if you want to move the 
contents of a CPU RAM (having a displacement [DISP] with respect to the 
workspace pointer) to RO, do the following: 


ENTRY STWP  R4 entry of OSR 


MOV at DISP (R4), RO 


Some of the frequently used CPU RAM's symbols and locations are listed below. 


PAD 
FAC 
ROLB 
R1LB 
OPCODE 
FLGSTS 
BUF ADR 
LRECLN 
CHRCNT 
RECNUM 
SCNOFF 
OPTLEN 
DEVLEN 
PAB VDP 
VWA 
GRD 


EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 


->E0 Start of CPU RAM in TI-99/4A console 
PAD+4A Start of 36 bytes available to DSR 
PAD+E] lower byte of RO 

PAD+E3 lower byte of Rl 

FAC+Q beginning of PAB, 1/0 operation code 
FAC+1 PAB——F lag/Status 

FAC+2 PAB-—Data Buffer Address 

FAC+4 PAB——Logical Record Length 

FAC+5 PAB—Character Count 

FAC+6 ; PAB——Record Number 

FAC+8 PAB——-Screen Offset 

FAC+9 PAB-—Option Length 

FAC+10 PAB-—Device Length 

FAC+12 PAB——Pointer to PAB in VDP RAM 

>8C02 address for VDP Write-Address operation 
>9800 address for GROM Read—Data operation 


0.4.2 Header and Linkage 8lock 


The DSR must contain a certain header starting at >4000 so that the linkage to 
the console software can be established properly. This header contains the 
following information: 7 


Ls 
és 


3. 
4, 
2 


validation flag ( >AA ). 
name(s) of device(s) being serviced by this DSR 
(the device name should be 7 characters or less). 
entry point(s) of the device(s) being serviced by this DSR. 
entry point of Power-up Routine, if necessary. 
entry point of Interrupt Routine, if necessary. 
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0.4.2.1 A Sample Program for Header and Linkage 8lock 


This section gives an example of the Header and Linkage 8lock in a typical 


DSR. 


The syntax of DX10 Assembler is obeyed in this program. ODX10 Assembler 


Language is similar to, but not identical with, the TI Editor/Assembler. 
Information on the language can be found in the 9900 Family Design Book. 


* 
* 
* 


PWRLNK 


PWRUP 


* 
* 
* 


INTLNK 


Sample Program Showing OSR Header Format 


RORG >4000 start of OSR 

BYTE >AA telling console this is a valid DSR 

BYTE l version number, always l 

DATA 0 not used in DSR calls; leave it 0 

DATA PWRLNK Power-up Routines' Link. PWRLNK is 
replaced by 0 if power-up set is not 

, necessary 

DATA 0 not used in OSR calls; leave it 0 

DATA OSRLNK DSR link; can't be 0 here : 

DATA 0 not used in OSR cails; leave it 0 

DATA INTLNK Interrupt Routine's Link. INTLNK is 
replaced by 0 if interrupt is not used 

DATA 0 not used in OSR calls; leave it 0 


xxx This Power-up Routine can be omitted if power-up 
**e initialization is not necessary for this peripheral 


DATA 0 linkage, set to 0 

DATA PWRUP entry point of power-up routine 
BYTE 0 name length; set to 0 

EVEN 


entry of power-up routine 


8 *R11 return to console software through Rll, 
if it is not destroyed 


*x* This Interrupt Routine can be omitted if Interrupt 
*** Request is never issued by this peripheral 


DATA Q linkage; set toQ 

OATA INTDSR entry point of the Interrupt Routine 
BYTE 0 name length; set to 0 

EVEN 


Sample Program (continued) 


INTDSR 


INTEND 


+ + + 94 


DOSRLNK 


OSRLK2 


DSRLK3 


ENTRY] 


ENTRY2 


ENTRYS 


EXIT 


B 


*R11 


entry of interrupt routine: 

IF interrupt request from this 
peripheral = true 

THEN begin interrupt service; 
reset interrupt request; 
GOTO INTEND 
END 

ELSE GOTO INTEND 


return to console software through Rll, 
if it is not destroyed 


ee Main Device Service Routine. Assuming three devices, 
*x* with names DEVICE, DEVICE/1, DEVICE/2, are 
*** supported in this peripheral. 


DATA 
DATA 
BYTE 
TEXT 
EVEN 
DATA 
DATA 
BYTE 
TEXT 
EVEN 
DATA 
DATA 
BYTE 
TEXT 
EVEN 


INCT 
: 


DSRLK2 
ENTRY] 
6 
‘DEVICE’ 


DSRLK3 
ENTRY2 

8 
‘DEVICE/1' 


0 

ENTRY3 

8 
'DEVIC/2' 


Rll 
i 2 


linkage to next device field 
entry point of ist device 
name length of lst device 
name of lst device 


linkage to next device field 

entry point of 2nd device 

name length of 2nd device 

name of 2nd device 

linkage to next device field (none) 
entry point of 3rd device 


neme length of 3rd device 
name of 3rd device 


entry of lst device servicing 
entry of 2nd device servicing 
entry of 3rd device servicing 


return to console software through 
* Ril, if it is not destroyed 
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0.4.3 Power-Up Routine 


For some peripherals, it is necessary to initialize the hardware at power-up 
time. It is suggested that a power-up routine be included to do the 
initialization through software for these peripherals. Power-up Link should 
be set in the Header Field as described above. 


Power—up routines are executed whenever the system is reset by either hardware 
or software. The console software searches all peripheral OSR for power-up 
routine addresses and executes them if they are found. Each power-up routine 
can use RO-R10. Upon entry, R12 is set to the beginning address of the CRU 
space for that peripheral DSR (note that this address is used to enable the 
OSR ROM). R11 contains the return address. 813 and R15 contain the 
memory-mapped addresses of GROM Read Data and VOP Write Address, 
respectively. Atl VDP and GROM operations can be indexed from these two 
registers. The power-up routine may use VOP RAM from 0 to the location 
pointed by CPU RAM >70, offset from workspace pointer - >€0). I[t can use all 
CPU RAM except location >55, <6D, and >CO through >OF offset from workspace 
pointer — >€0. 


All power-up routines must return with B- ¥*R11. 
0.4.4 Interrupt Routine 


[f the peripheral issues [nterrupt Request to the 9900 CPU, the DSR should 
also include an interrupt routine and [nterrupt Link in the Header as 
described above. Every interrupt that is not. recognized as console interrupt 
(VDP or 9901 Timer) causes the console software to execute every interrupt 
routine it can find. The interrupt routine must check to see whether the 
Interrupt Request is raised by this peripheral. I[f it is not, exit by 

B *Ril. 


The interrupt routine may use R1-R8, and R10. The contents of R11-R15 are the 
Same as those of the Power-up Routine Section. The interrupt routine and Main 
OSR can split the allocation of CPU RAM from >4A to >6D offset from workspace 

pointer — >&0 }. 


All interrupt routines end with 8B *R11. Interrupt Request raised by the 
peripheral must be cleared before exit. 


To exit DSR, do 


INCT Rll 
B *RI1 
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GLOSSARY 


ALU Arithmetic Logic Unit. 


bit Smallest unit of memory; Binary digil. 

byte 8 bits of memory. 

cartridge 

memory ROM space found within a plug-in cartridge. 

CPU Central Processing Unit. 

CRU Communication Register Unit (1/0 techique for TMS 9900 
Microprocessor). 

DRAM Dynamic Random Access Memory. 

DSR Device Service Routine (TMS 9900 machine language for 
Device Interface). 

GPL Graphics Programming Language. 

GROM Graphics Read-Only Memory (TMC 0430). This memory device 


is a 6144 byte read-only memory with on-board 13-bit 
program counter. The program counter can be written or 
read through an 8bit interface and will] automatically 


increment. 
I/O Input/Output. 
LSB Least Significant Bit. 
LSBY Least Significant Byte. 
MMD Memory—Mapped Device. 
MSB Most Significant Bit. 
MSBY Most Significant Byte. 
MPU Microprocessor Unit. 
PAB Peripheral Access Block. 
PC Program Counter. 
PCB Printed Circuit Board. 
PEU Peripheral Expansion Unit. 


57 


RAM 
ROM 
SRAM 
VOP. 


WORD 


Random Access Memory. 

Read-Only Memory. 

Static Random Access Memory. 

Video Display Processor (TMS 9918A). 


16 bits/2 bytes of memory. 


